Addresses issue #18 by implementing comprehensive improvements to prevent "No fallback system browsers available" errors and internal server errors during PDF generation.

Problem

Users were experiencing internal server errors when generating PDFs, particularly with work orders and burial sites. The root cause was that browser installation only occurred after the first PDF generation failure, leading to:

• Users getting errors on their first PDF generation attempt
• Poor error messages that were difficult to debug
• No validation that browsers were actually working after installation
• Limited retry logic for transient failures

Solution

This PR transforms PDF generation from a reactive approach (install browsers after failure) to a proactive approach (ensure browsers are available before use).

Key Changes

1. Proactive Browser Management

• New browserManager.helpers.ts handles all browser installation and validation
• Browsers are installed and validated during application startup
• Smart browser selection prioritizes user preferences and last known working browser

2. Enhanced Error Handling & Retry Logic

• Configurable retry attempts (default: 3) with exponential backoff
• Intelligent error detection for browser-related vs other issues
• Automatic browser recovery during PDF generation failures
• Detailed error messages including attempt counts for better debugging

3. New Configuration Options

// Control retry behavior
'settings.printPdf.maxRetries': 3

// Browser installation preferences  
'settings.printPdf.installBothBrowsers': true
'settings.printPdf.proactiveInstallation': true
'settings.printPdf.forceReinstallOnStartup': false
'settings.printPdf.reinstallAfterDays': 30

4. Application Startup Integration

• Modified app.ts to initialize browsers during startup (unless in test mode)
• Graceful degradation - application starts even if browser installation fails
• Comprehensive debug logging under sunrise:helpers:browserManager namespace

5. Database Settings Tracking

• pdfPuppeteer.lastSuccessfulBrowser - tracks last working browser
• pdfPuppeteer.lastInstallationDate - enables automatic reinstallation scheduling

Testing

The improvements include comprehensive tests:

// Configuration validation
✓ All new settings working correctly with proper defaults

// PDF generation reliability  
✓ Shows "after 3 attempts" in error messages
✓ Retry logic attempting multiple times vs failing immediately
✓ Better error messages for debugging

// Application startup
✓ Starts successfully with browser initialization

Benefits

• Eliminates first-time PDF failures: Browsers ready before users need them
• Better user experience: No more "try again and it might work" scenarios
• Improved debugging: Clear error messages with attempt counts and specific failure reasons
• Configurable reliability: Administrators can tune retry behavior for their environment
• Backward compatible: Existing installations continue working unchanged

The changes maintain full backward compatibility while providing significantly improved reliability for PDF generation operations.

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.